home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / gus / dmp32287.zip / DMP32.DOC < prev    next >
Text File  |  1994-03-13  |  9KB  |  201 lines
  1.  
  2.  
  3.                                DMP32.DOC
  4.  
  5.            Documentation for the Dual Module Player/32 v2.87
  6.  
  7.                      Copyright (C) 1994 Otto Chrons
  8.  
  9.  
  10.  DMP32.EXE is  a program  demonstrating the  capabilities of the DSMI/32
  11.  programming interface (DSMI stands for Digital Sound & Music
  12.  Interface). It's a standalone module  player running in 32-bit
  13.  protected mode with  which  you can play STM, S3M, 669, FAR and MTM
  14.  files  as well  as Amiga modules (MOD or NST). DMP32 is cardware so you
  15.  can freely distribute  it and I hope you did, as long as you include
  16.  this help file with the executable. If you like the product, please
  17.  send me a postcard to the address shown on the endscreen of DMP32!!
  18.  
  19.            Here is the command line syntax:
  20.  
  21.            DMP32 [options] [modulename] [@listfile] [options]
  22.  
  23.            Where:
  24.            ------
  25.            modulename : name of a module (wildcards *,? allowed)
  26.            listfile   : name of a file containing list of module names
  27.  
  28.            options  : -Sxxxx          set sampling rate 4000-44100
  29.                                       alternatively 4-44
  30.                       -H or -?        show help screen
  31.                       -Ix             interrupt number
  32.                       -Pxxx           port address (use 42 for PC speaker)
  33.               -Dx             DMA channel
  34.               -O              Scramble module order
  35.               -L              Inhibit looping
  36.               -M              Mono mode (SB16 & PAS)
  37.               -Q              Quality mode (on 8-bit cards only)
  38.               -Cx             Desired card where x is:
  39.                     1 for Sound Blaster
  40.                     2 for Sound Blaster Pro
  41.                     3 for PAS+
  42.                     4 for PAS16
  43.                     5 for SB16
  44.                     8 for Windows Sound System & compat.
  45.                           (like AudioTrix Pro)
  46.                     9 for Gravis Ultrasound
  47.               -Txxx           Buffer size xxx (0-32000)
  48.               -E              Disable extended tempos (MOD only)
  49.               -Axxx           Amplify by xxx, 31 is normal volume
  50.               -B              Disable EMS usage
  51.               -8              Force an 16-bit card into 8-bit
  52.                       mode (works with Aria, PAS16 and WSS)
  53.               -Nxx            Set default panning to xx (0-63,100)
  54.                       100 = Surround sound
  55.               -W[command]     Automatic DOS shell, executes optional
  56.                       'command'.
  57.               -Zxx          Use 25/50 row display
  58.                       -X              Quiet screen mode. DMP32 writes nothing
  59.                       on the screen
  60.  
  61.  If you use some options all the time, you can put them into an
  62.  environment variable DMP32:
  63.  
  64.     Example:
  65.  
  66.  You always want to use quality mode and sampleing rate of 22kHz and
  67.  mono mode, put following line into your AUTOEXEC.BAT
  68.  
  69.         SET DMP32=-q -s22 -m
  70.  
  71.  NOTE!  You cannot override single letter options (-l,-o,-m,-q) with
  72.  command line parameters. All other options can be overriden.
  73.  
  74.  Alternatively you can use the CmdLine parameter in DMP32.INI for same
  75.  purpose.
  76.  
  77. ┌─────────────────────────────────────────────────────────────────────────┐
  78. │You may have to  give your soundcard's IRQ  number and/or port address   │
  79. │if DMP32 fails to find them. If you don't provide both values then DMP32 │
  80. │will assume 220h for port address, and 7 for interrupt number. Giving    │
  81. │wrong address  will hang  your machine,  but wrong interrupt number      │
  82. │only stops the playing after a second. The "/C" option is useful if you  │
  83. │want to use some other card, than the one DMP32 automatically detects.   │
  84. └─────────────────────────────────────────────────────────────────────────┘
  85.  
  86.  You don't  have  to add  any extension  to  the name,  because the
  87.  program will try  extensions MTM, AMF, STM, 669, S3M, FAR, MOD and NST
  88.  if it doesn't find the file. Note that you can supply many modulenames
  89.  and list files.
  90.  
  91.            Example:
  92.  
  93.            DMP32 beyond -s20 *.NST @goodmods
  94.  
  95.            goodmods is a text file containing following lines:
  96.            occ-san
  97.            stars
  98.            intro3
  99.  
  100.  DMP32  will use  the  sampling  rate  of  20KHz  and  play following
  101.  modules: BEYOND.MOD,  OCC-SAN.STM, STARS.MOD, INTRO3.MOD  and all
  102.  .NST-files in the current directory.
  103.  
  104.  DMP32 has also a config file called DMP32.INI. It should be placed in the
  105.  same directory with DMP32.EXE but DMP32 will also find it if it's somewhere
  106.  in the PATH. See the file itself for explanations on config switches
  107.  and strings.
  108.  
  109.  You can also play modules inside archives by specifying in DMP32.INI how
  110.  to extract files from the archive.
  111.  
  112.  
  113.                                 How to use DMP32
  114.  
  115.  After DMP32 has  loaded the first  module, it starts  to play it and
  116.  shows some information about  it. DMP32 displays module's  name, its file
  117.  size, the amount of  memory used for module and sampling rate.  Because
  118.  of the AMP's Intelligent Module Loader  (IML) modules  usually take
  119.  10-30% less  space. I've  seen a 244Kb module shrink into 151Kb when I
  120.  loaded it with DMP32. While playing, DMP32 updates fields showing current
  121.  pattern, row, elapsed time, volume and sampling rate. Under these
  122.  fields are four lines showing the current status of the corresponding
  123.  tracks. Here is an example:
  124.  
  125.  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  126.    bassdrum            │ F#2 │ 64 │               │ ■■■■■■■■■■■■■■■■■■■■■
  127.    strings7            │ D-3 │ 20 │ ARPEGGIO      │ ■■■■■■■■■■■■■■■
  128.    guitar42            │ E-2 │ 12 │ PORT.NOTE     │ ■■■■■■■■■■■
  129.    guitar44            │ G-2 │ 57 │ FINE VOL      │ ■■■■■■■■■■■■■■■■■■
  130.  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  131.  
  132.  The first  field shows  the instrument  currently playing  on that
  133.  track. Second is the note value, third its volume and fourth indicates
  134.  what special command is running. The bar simulates a VU  meter on music
  135.  equipment, but you shouldn't take it  as  an exact  representation of
  136.  the music  level, it's there because it looks nice!
  137.  
  138.  The rest of the screen is filled with instrument names. The numbers before an
  139.  instrument name indicate the channels that instrument is playing on.
  140.  
  141.  Pressing 'H'  brings up a  quick-help showing  command line options and
  142.  keys used to control the program.
  143.  
  144.            Keys :
  145.           ────────
  146.  
  147.            P            pause module, any key resumes
  148.            1-9          turn track xx on/off
  149.            0            turn selected track on/off
  150.            D            DOS shell (write EXIT to get back)
  151.            N            load next module (if you have supplied more than one)
  152.            S            stereo mode on/off (SB Pro), default is on
  153.            F            filter on/off (SB Pro), default is off
  154.            left/right   Jump to next/previous pattern
  155.            up/down      select track
  156.            F1-F10,+,-   set volume
  157.            [,]          Set new speed
  158.            {,}          Set new tempo
  159.            V            Real/fake volume bars
  160.            L,M,R,U      Panning full left/mid/right/surround
  161.        , .          Panning left/right
  162.        Z        Switch between 25- and 50-row display
  163.        H            Help screen
  164.        ESC          exit
  165.  
  166.  Try this module player  with all the modules  you have, and if you
  167.  encounter problems with any modules, inform the author. Have fun.
  168.  
  169.  
  170.                ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  171.                 Contacting the author
  172.                ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  173.  
  174.        ┌─────────────────────────────────────────────────────────────────────┐
  175.        │                                                                     │
  176.        │   By mail:                                                          │
  177.        │   ────────                                                          │
  178.        │                                                                     │
  179.        │            Otto Chrons                                              │
  180.        │            Pyydyspolku 5                                            │
  181.        │            FIN-36200 Kangasala                                      │
  182.        │            FINLAND                                                  │
  183.        │                                                                     │
  184.        │   InterNet:                                                         │
  185.        │   ──────────                                                        │
  186.        │            c142092@lehtori.cc.tut.fi (fastest method to contact)    │
  187.        │                                                                     │
  188.        └─────────────────────────────────────────────────────────────────────┘
  189.  
  190.     Newest version is always available at:
  191.  
  192.        ┌────────────────────────────────────────────────┐
  193.        │ R.A. LAW         +358-37-5849007           24h │
  194.        │ ftp.uwp.edu      /pub/msdos/modplayers         │
  195.        │ ftp.wustl.edu    /pub/MSDOS_UPLOADS/modplayers │
  196.        └────────────────────────────────────────────────┘
  197.  
  198.         See CABINET.DMP3for a list of DMP/DMP32 support sites in Finland.
  199.  
  200.         See DMP32.REV for revision history.
  201.